package com.example.web.service;

import com.example.web.entity.Menu;
import com.example.web.entity.MenuTree;

import java.util.List;

/**
 * 菜单服务接口
 */
public interface MenuService {
    
    /**
     * 查询所有菜单
     * @return 菜单列表
     */
    List<Menu> getAllMenus();
    
    /**
     * 获取菜单树形结构
     * @return 菜单树
     */
    List<MenuTree> getMenuTree();
    
    /**
     * 根据ID查询菜单
     * @param id 菜单ID
     * @return 菜单信息
     */
    Menu getMenuById(Long id);
    
    /**
     * 根据角色ID查询菜单列表
     * @param roleId 角色ID
     * @return 菜单列表
     */
    List<Menu> getMenusByRoleId(Long roleId);
    
    /**
     * 根据角色ID查询菜单树
     * @param roleId 角色ID
     * @return 菜单树
     */
    List<MenuTree> getMenuTreeByRoleId(Long roleId);
    
    /**
     * 根据用户ID查询菜单列表
     * @param userId 用户ID
     * @return 菜单列表
     */
    List<Menu> getMenusByUserId(Long userId);
    
    /**
     * 根据用户ID查询菜单树
     * @param userId 用户ID
     * @return 菜单树
     */
    List<MenuTree> getMenuTreeByUserId(Long userId);
    
    /**
     * 根据用户ID查询权限列表
     * @param userId 用户ID
     * @return 权限列表
     */
    List<String> getPermissionsByUserId(Long userId);
    
    /**
     * 新增菜单
     * @param menu 菜单信息
     * @return 结果
     */
    int addMenu(Menu menu);
    
    /**
     * 修改菜单
     * @param menu 菜单信息
     * @return 结果
     */
    int updateMenu(Menu menu);
    
    /**
     * 删除菜单
     * @param id 菜单ID
     * @return 结果
     */
    int deleteMenuById(Long id);
    
    /**
     * 批量删除菜单
     * @param ids 需要删除的菜单ID数组
     * @return 结果
     */
    int deleteMenuByIds(Long[] ids);
}